Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 18 - QuickDraw 3D Pointing Device Manager / QuickDraw 3D Pointing Device Manager Reference

QuickDraw 3D Pointing Device Manager Routines / Creating and Managing Controllers

Q3Controller_Track2DCursor

You can use the Q3Controller_Track2DCursor function to determine whether a controller is currently affecting the two-dimensional system cursor.

TQ3Status Q3Controller_Track2DCursor (
TQ3ControllerRef controllerRef, 
TQ3Boolean *track2DCursor);

controllerRef

A reference to a controller.

track2DCursor

On exit, a Boolean value that indicates whether the specified controller is currently affecting the two-dimensional system cursor (kQ3True) or not (kQ3False).

DESCRIPTION

The Q3Controller_Track2DCursor function returns, in the track2DCursor parameter, a Boolean value that indicates whether the controller specified by the controllerRef parameter is currently affecting the two-dimensional system cursor but the z axis values and orientation of the system cursor tracker are being ignored. If the specified controller is not attached to the system cursor tracker or if that controller is inactive, track2DCursor is set to kQ3False.

SPECIAL CONSIDERATIONS

In general, you need to use this function only if you are writing a device driver for a controller.